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INTRODUCTION 


The Chalk Board PowerPad offers an 
alternative to the typewriter-style keyboard in 
working with your home computer. For many 
people this development makes contact with 
the computer less frustrating and more fun. 

But for those who have mastered the com- 
puter keyboard and are familiar with the 
BASIC programming language, PowerPad 
offers some exciting and powerful new dimen- 
sions to writing and executing programs. While 
you learn to write programs for PowerPad, 
you gain a deeper working knowledge of your 
own home computer. | 

The information in this manual explains and | 
demonstrates how to give commands to 
PowerPad in Commodore 64 BASIC. It pro- 
vides a series of activities which will familiarize 
you with PowerPad's programming. Lastly, 
there are some challenging questions for you to 
consider on your way to more sophisticated 
programming. 

you are unfamiliar with the operation of 
the Chalk Board PowerPad, be sure to refer to - 
the PowerPad User's Guide, which accompanied | 
your PowerPad. This guide contains instruc- 
tions concerning how to connect the pad to 
your Commodore 64 home computer system. 
Find the section of the directions which illus- 
trates use with the Commodore 64 computer. 
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Getting Started 


e Do not try to begin without reading the 
PowerPad User's Guide. 

* Refer to the section which illustrates the 
use of PowerPad with Commodore 64 
home computers. 

* [nsert the overlay included with this 
product by gently guiding the overlay's 
frame into the groove around PowerPad's 
work surface. 


Important Note: 


Do not plug in PowerPad until you have 
entered, saved and run a program. 


When you plug PowerPad into the Commodore 
64's control port 1, the pad communicates 
with the computer along some of the same cir- 
cuit lines as the keyboard. Consequently, 
whenever PowerPad is plugged into the port 
and you type a key on the keyboard, the com- 
puter receives invalid data from both the pad 
and the keyboard. However, no electrical 
damage can occur. 

All of the sample programs in this manual do 
watch for the space bar to halt execution. Once 
any of these programs is running, touch no key 
other than the space bar. Also, be sure that the 
SHIFT LOCK key is in the OFF (up) position. 

To use any PowerPad program in BASIC 
with the Commodore 64, you first type RUN, 
then press return and then plug in the pad. 


PowerPad Test in BASIC 
The Chalk Board PowerPad is a pressure- 


sensitive input device. It senses the touch of a 
finger (or any blunt stylus) and provides the 
location of the point of contact. The location 
point is given in the form of X and Y coordi- 
nates (similar to those found on the Cartesian 
Coordinate System). Figure 1 shows how the 
coordinates are arranged on the PowerPads5 sur- 
face. The values on each axis range from 0 to 
119. There are 120 rows by 120 columns, or 
14,400 different unes рои d 

| can sense. Figure 1 also shows a sample point 
E ad and the X and Y values that would be returned 
Sample Point by touching the pad at that point. 


Figure 1. 
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PowerPad sends the X and Y coordinates to 
your computer in a serial format. This means 
that the values for X and Y are converted to 
binary numbers and are sent one bit at a time. 
To read the X and Y values, the computer must 
read the first bit, request that the next bit be 
sent, read that bit, and so on, until all of the 
bits have been read. The computer must then 
reassemble those bits. 

There are a total of 16 bits. The first two 
have no meaning and should be ignored. The 
following seven are for the Y value, and the 
last seven are for the X value. 

Program 1, “PowerPad Test’’ uses subroutines 
to scan the pad and print to the screen the X 
and Y coordinates of the point of contact. The 
subroutines can be called by any BASIC pro- 
gram to communicate with PowerPad. 

The first subroutine (lines 10000-10070) ini- 
tializes the variables used by the other subrou- 
tines. It also tells you to plug in PowerPad. 

The second subroutine (lines 11000-11250) 
sets up control port 1 to talk to PowerPad and 
tells PowerPad to begin scanning for points 
being touched. The fifth time that this 
subroutine is called, the message “UNABLE TO 
TALK TO POWERPAD. DID YOU PLUG 
PAD INTO CONTROL PORT 17’ is printed. 
The subroutine then falls through to a section 
which restores proper communication between 
the computer and its keyboard. This section 
must be executed before the program halts. 
Failure to do so may leave the keyboard unread- 
able, even if you unplug PowerPad. 

The third subroutine (lines 12000-12090) 
determines whether PowerPad or the space bar has 
been touched. If PowerPad has been touched, it 
is ready to send an X and Y coordinate, and the 
subroutine returns with the variable SENSE 
equal to zero. If the space bar has been pressed, 
the message “PROGRAM STOPPED" is printed 
and the exit routine executed. Otherwise the 
subroutine continues to wait for you to touch 
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the pad or space bar. If the counter C reaches 
the value 30, then PowerPad is not talking to 
your computer and the subroutine jumps to the 
initialization subroutine (INIT PAD). 

_ The fourth subroutine (lines 13000-13070) reads 
the values of the X and Y coordinate from 
PowerPad. It is called after the third subroutine 
has determined that you have touched the pad. 
The fourth subroutine calls the fifth subroutine 
twice: first to read in Y, and again to read in X. 
The fourth subroutine then tells the pad to resume 
scanning for another touch. It returns with the 
variables X and Y set to the position of the point 
of touch. 

The fifth subroutine (lines 14000-14090) reads 
the value of one number (either X or Y) from 
PowerPad. It is called only by the fourth sub- 
routine. It is this subroutine which assembles 
the binary bits coming from PowerPad back 
into a whole number. The value of the number 
read is returned in the variable BYTE. 

A flow chart ( Figure 2) which depicts sche- 
matically the BASIC PowerPad Test program 
follows the listing of Program 1. 


Suggestions: 


Chalk Board has taken great care to insure that 
this and subsequent programs have been printed 
correctly and that they run properly. Should 
you have any difficulty in getting any of the 
programs in this manual to run properly, 
check your entries to be sure that you have 
typed each line correctly. Once you have typed 
your program and are sure that it runs properly, 
save it on a diskette or cassette to simplify using 
the program in the future. Refer to the Users 
Guide which came with your Commodore 64 
computer for instructions concerning saving 
programs. 

To help you keep track of the programs you > 
create, three PowerLog™ cards are included in. 
this package. Be sure to label your cassette 
tapes or diskettes carefully and clearly. Use the 
PowerLog cards to record the identity and loca- 
tion of your own programs. 

As you type program 1, as well as all of the 
other example programs in this manual, you 
can save time by leaving out the REM 
statements. 
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Program 1: PowerPad Test (all BASIC). 


NO OO —J OY Ui i» оом н 


109 
110 
120 
130 
140 
150 
200 
210 
220 
230 
240 


REM ******** pOWERPAD TEST ******** 
REM POWERPAD DEMONSTRATION PROGRAM 

REM IN BASIC FOR THE COMMODORE 64. 

REM NOTE: USE THE SUBROUTINES 

REM IN LINES 18009-14699 

REM FOR YOUR OWN PROGRAMS 

REM (YOU MAY LEAVE OUT ALL REMS) 


REM CHALK BOARD, INC. 1983 
REM XK ook oko Ж 


PRINT CHR$(147): REM CLEAR SCREEN 

PRINT "POWERPAD TEST" 

СО5ОВ 10010: REM INIT VARS 

СО5ОВ 11010: REM INIT PAD 

GOSUB 12010: REM CHECK IF POINT/SPACE PRESSED 
GOSUB 13010: REM GET X AND Y 

REM USE X AND Y 

IF X-0 AND Y-0 THEN 140 

PRINT (RSs XE" EY 

GOTO 140 


REM ХХХХХХХХХХХХХХХХХХХХХХХХХХХХХх XK 


10000 REM INIT VARIABLES 
10010 PRINT "PLUG POWERPAD INTO CONTROL PORT 1." 


10020 BDDR-56323: REM SDC03 = CIA DDRB 
10030 BPR 256321: REM SDC@l = CIA PRB 
18848 ADDR=56322: REM SDC@2 = CIA DDRA 
10050 АРЕ -56320: REM SDC@@ = CIA PRA 
10060 IC=@: REM COUNTS # OF CALLS OF INIT PAD 


10070 RETURN 

10080 REM k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 

11000 REM INIT CONTROL PORT AND POWERPAD 

11010 IC=IC+1: IF IC=5 THEN 11119 | 

11020 POKE ADDR, 0: REM SET UP PRA TO WATCH SPACE 
11030 POKE BDDR,22: REM " CTRL PORT 1 TO TALK TO PAD 
11040 POKE BPR, 0: REM ZERO CLOCK AND CLEAR LINES 
11050 POKE BPR, 2: REM PULSE CLEAR LINE 

11060 РОКЕ ВРЕ, @: REM (BEGIN SCANNING) 

11070 RETURN 

110850 ВЕМ: ======55== 

11100 REM INIT HAS BEEN CALLED 5 TIMES 








11110 
11120 
11130 
11200 
11210 
11220 
11230 
11240 
11250 
11260 
12000 
12010 
12020 
12030 
12040 
12050 
12060 
12070 
12080 
12090 
12100 
12110 
13000 
13010 
13020 
13030 
13040 
13050 
13060 
13070 
13080 
14000 
14010 
14020 
14030 
14040 
14050 
14060 
14070 
14080 
14090 


IF DTA=@ THEN ВУТЕ=ВУТЕ+128: 


PRINT “UNABLE TO TALK TO POWERPAD. DID" 
PRINT "YOU PLUG PAD INTO CONTROL PORT 1?" 
REM ========== 


REM RE~ENABLE KEYBOARD 

PRINT "UNPLUG POWERPAD BEFORE TYPING." 
POKE ADDR,255: REM RESTORE DDRA 

POKE APR, 255: REM RESTORE PRA 

POKE BDDR, 0: REM RESTORE DDRB 


END 
КЕМ ХЖ АККЖ КЖ ЖКЖ 


REM CHECK IF POINT OR SPACE BAR PRESSED 

C=0: REM COUNTER 
SPACE-(PEEK(APR)AND128)/128: REM CHECK SPACE 
IF SPACE-1 THEN 12050: REM SPACE NOT PRESSED 
PRINT "PROGRAM STOPPED.": GOTO 11210 
SENSE-(PEEK(BPR)AND8)/8: REM CHECK SENSE LINE 
IF SENSE-1 THEN 12080: REM POINT NOT FOUND 
IC20: RETURN: REM POINT FOUND 

C-C«*1: IF C«30 THEN 12020: REM 30 TRIES 
GOSUB 11010: REM CALL INIT AGAIN 

СОТО 12010 

REM “%“*******%******%**%********w**w**** 

REM GET X AND Y 

POKE BPR,4: REM PULSE CLOCK LINE 

POKE BPR,0@: REM (SHIFT OFF FIRST BIT) 

GOSUB 14010: Y-BYTE: REM GETBYTE 

GOSUB 14010: X-BYTE: REM GETBYTE 

POKE BPR,2: REM PULSE CLEAR LINE 

POKE BPR,@: REM (RESUME SCANNING) 

RETURN 

REM KERR KKK KKK KKK KKK KEK KKK KK KR 

REM GET BYTE 

ВҮТЕ=0 

FOR L=l TO 7: REM READ AND COMBINE 7 BITS 
POKE BPR,4: REM PULSE CLOCK LINE 

POKE BPR,@: REM (SHIFT OFF FIRST BIT) 
DTA=PEEK(BPR) AND 1: REM READ DATA LINE 

REM BUILD VALUE 
BYTE=BYTE/2: REM IN BYTE 
NEXT L 

RETURN 


START 


INIT COUNTER 


PRINT 
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Figure 2. Flowchart of PowerPad Test Program 


How PowerPad Works 


This section is designed for the experienced 
programmer who wants to know more about how 
PowerPad communicates with the Commodore 64 
computer. The machine language version of the 
PowerPad Test program appears at the end of 
this section. You need not understand machine 
language to take advantage of this faster- 


running program. 
PowerPad's Interface Lines and Shift Register: 


PowerPad uses four lines to interface to the 
Commodore 64. The CLOCK and CLEAR lines 
are outputs from the computer to PowerPad. 
The DATA and SENSE lines are outputs from 
PowerPad to the computer. 

The CLEAR line is used to tell PowerPad to 
scan for a touch point. It must be pulsed high 
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(brought from low to high and back to low 
again) to begin the scan. 
The SENSE line is PowerPads signal that a 
touch has occurred. This line is normally high. 
When you touch the pad, the line goes low. It 
remains low until the CLEAR line is pulsed. 
When PowerPad senses a touch, it stores the 
X and Y coordinate values in a 16-bit shift 
register. Figure 3a shows an example of what 
the shift register might contain immediately 
after the pad has sensed a touch. The left-most 
two bits are always loaded with "01" The next 
seven bits to the right contain the value for Y, 
and the right-most seven bits hold the value for 
| X. The X and Y values both are stored with 
their least significant bit to the left. So in Figure 
3a, the shift register is shown holding the coor- 
dinates (X —2, Y —5). 
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Initial Contents of 
Shift Register 
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TO 
COMMODORE 






At any time the computer can read only the 
left-most bit of the shift register. This bit is 
inverted (a 1 becomes a 0, and a 0 becomes a 1) 
and then sent out on PowerPads DATA line. 

The CLOCK line enables the computer to 
read the other bits in the shift register. Each 
time the CLOCK line is pulsed (set from low to 
high and back to low again), the shift register 
moves its contents one position to the left. The 
left-most bit is lost and a "0" is shifted into the 
right-most position. Figure 3b shows the con- 
tents of the shift register after the CLOCK line 
has been pulsed once. Figure 3c shows the 
register after a second shift. The first two shifts 
are always necessary to remove the “OL” in the 
left-most bit positions. At this point the computer 
can begin reading the seven bits corresponding 
to the Y value, followed by the seven bits for 
the X value. Remember that since the bits com- 
ing out of the DATA line are inverted, the 
computer must invert them again. 

The CLOCK line should be held low while 
PowerPad is scanning. If the line is pulsed 
before the pad finds a point, the shift register 
immediately loads garbage while the pad con- 
tinues to scan for a point. Then when the pad 
finds the next point, it is unable to put the cor- 
rect data into the shift register. At this point, 
pulsing the CLEAR line clears the garbage from 
the register and causes the pad to resume nor- 
mal operation. 
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Programming Considerations 


As PowerPad scans its matrix of switches, it 
starts at coordinates (X =0, Y =0), then looks 
at (X=0, Y=1), etc., up to (X=0, Y=119). It 
then looks at the next column, (X —1, Y —0) up 
to (X —1, Y —119), and continues scanning each 
successive column until it reaches (X —119, 

Y —119). At this point PowerPad scans again, 
starting with (X —0, Y —0). If more than one 
point is closed in the switch matrix, PowerPad 
scans to the first point, lowers the SENSE line 
and waits until the computer reads the coordi- 
nates. When the computer acknowledges reading 
the coordinates (by pulsing the CLEAR line), 
PowerPad resumes scanning the switch matrix 
at the next point following the one it just 
reported. When it finds another closed switch 
in the matrix, it again lowers the SENSE line 
and waits for the computer to read the coordi- 
nates before continuing to scan. 

Each time PowerPad scans through the point 
(X —0, Y —0), it reports a switch closure at that 
point, even if nothing is touching the pad. This 
is a very useful feature. If a program reads the 
pad and finds coordinates (X —0, Y —0) two times 
in succession, then it knows that PowerPad has 
scanned all the way through its switch matrix 
without finding any closed switch points. In 
other words, this indicates that nothing is 
touching the pad. Programs can use this feature 
to detect when you have lifted your finger off 
PowerPad. 

It is possible that some points in PowerPad's 
switch matrix may close permanently due to 
extraordinary wear and tear. 

When a point becomes shorted, PowerPad 
reports its coordinates each time it scans 
through the matrix, just as if you were apply- 
ing continuous pressure to that point. Writing a 
routine to detect shorted points and to ignore 
them is not difficult. At the start of a program, 
create a table of all shorted points (points 
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reported as being touched while nothing is really 
touching PowerPad) with the exception of 

(X —0, Y —0). Later in the program, whenever 

a location read from the pad matches any of 

the points in the table, the program ignores 

that location. 


Commodore 64's Control Port Interface 


When you plug PowerPad into Commodore 
the 64 control port 1, the CLOCK, CLEAR, 
SENSE, and DATA lines from the PowerPad are 
connected to Port B of a 6526 Complex Interface 
Adapter chip (CIA) inside the Commodore 64 
(see Figure 4). All PowerPad software expects 
to find PowerPad in control port 1. 


DATA TO/FROM 
COMPUTER 





Control 
Port 1 


Commodore 64 
Computer 


Subminiature D-type plug 
on PowerPad Cable 


Control Port 1 CIA Port B 
Pin No. it 





1 
2 
3 
4 
7 
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1 
2 
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The four CIA lines used by PowerPad аге 
also used by the Commodore 645 keyboard. 
This sharing of lines makes normal access to 
the keyboard impossible while PowerPad is 
connected. However, all of the example pro- 
grams in this manual are able to examine the 
space bar and allow you to use that key to halt 
the programs. If you wish to obtain additional 
information concerning how to read the key- 
board while PowerPad is plugged in, send your 
questions along with your PadMasters Guild 
membership application (see last page). 

The registers of the 6526 CIA are memory 
mapped in the Commodore 64 to locations 
$DCO0 (decimal 56320) through $DCOF 
(decimal 56335). You can access the registers by 
loading and storing (or PEEKing and POKEing) 
data at these addresses. There are two particu- 
lar registers in the 6526 with which we are 
concerned. They are: the Port B Data Direction 
Register, or DDRB, at $DC03; and the Port В 
Register, or PRB, at $DCOI. 

The individual bits of DDRB determine 
whether a line on the control port is an input to 
or an output from the Commodore 64. Setting 
a bit to O assigns the corresponding line as an 
input, and setting it to 1 assigns the line as an 
output. PowerPad requires that lines 0 and 3 be 
inputs, and lines 1 and 2 be outputs. So you 
should store the value 6 (binary 0110) as the 
low four bits of DDRB. 

Once you have set up DDRB, you can read 
the DATA and SENSE lines and write to the 
CLOCK and CLEAR lines through PRB. Set- 
ting a bit of PRB to 0 or 1 sets the correspond- 
ing output line low or high, respectively. Setting 
an input line low or high sets its corresponding 
PRB bit to 0 or 1, respectively. Given below are 
machine language examples of how to set up 
and talk to PowerPad: 


| 
| 


LDA 
STA 


LDA 
STA 


LDA 
STA 


LDA 
STA 


LDA 
AND 


LDA 
AND 


#506 
$DC03 


%500 
SDC@1 


%502 
SDC@1 


#504 
SDC@1 


5рс01 
$401 


S$DC01 
5%08 


Біпагу 0000 0110 
set up DDRB (2 inputs & 2 outputs) 


че че 


binary 0000 0000 
set CLEAR and CLOCK low 


че че 


Біпагу 0000 0010 
set CLEAR high and CLOCK low 


=e `. 


binary 0000 0100 
set CLOCK high and CLEAR low 


<. чә 


read the DATA line 
Біпагу 0000 0001 


че че че че 


giving: A = @ for DATA = low 
A = 1 for DATA = high 
; read the SENSE line 
; binary 0000 19000 
; giving: A = Ø for SENSE = low 
$ A = 8 for SENSE = high’ 


While entering Program 2, make certain that 
the DATA statements are exactly as shown 
here. Otherwise the program will not run pro- 
perly and could even cause the computer to 
“freeze” If you have a disk or cassette, save the 
program before running it. 

These Data statements contain the machine 
language subroutines taken trom the listings 
in Appendix B. 
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Program 2: 

PowerPad Test (BASIC with machine language 
subroutines. See Appendix B for an assembly 
language listing of the subroutines). 


l REM kkkkkkkKkK DOWERPAD TEST *ckkok k kk 
REM POWERPAD DEMONSTRATION PROGRAM 
REM IN BASIC WITH MACHINE LANGUAGE 
REM SUBROUTINES FOR COMMODORE 64. 
REM NOTE: USE THE SUBROUTINES IN 
REM LINES 10000-15520 

REM FOR YOUR OWN PROGRAMS 

REM (YOU CAN LEAVE OUT ALL REMS) 


REM CHALK BOARD, INC. 1983 
10 REMS žžk k kk k kk k k kk k k k k k kk kk kk k k k k k k 


хо OO —J OY Ul 4 ио м 


100 РВІМТ СНК (147): REM CLEAR SCREEN 
110 PRINT "POWERPAD TEST" 

120 GOSUB 190010: REM SET UP M.L. 

130 GOSUB 11010: REM CALL INITPAD 

140 GOSUB 12010: REM CALL GETSENSE 
150 GOSUB 13010: REM CALL GETXY 

200 REM USE X AND Y 


210 
220 
230 
240 
10000 
10010 
10020 
10030 
10040 
10050 
10060 
11000 
11010 
11020 
11030 
11040 
11100 
11110 
11120 
11130 
11200 
11210 
11220 
11230 
11240 
12000 
12010 
12020 
12030 
12040 
12100 


IF X=@ AND Y=@ THEN 149 
PRINT"X=";X; " 


GOTO 140 
REM ck k e de k e k ke k ke k ke k ke k k k ke k k k k k k k k k 


үш"; Ү 


REM SET UP MACH. LANG. SUBROUTINES 

PRINT "PLUG POWERPAD INTO CONTROL PORT 1." 
GOSUB 14010: REM POKE ІМ M.L. 

IC=@: REM COUNTS CALLS OF INIT 

PRINT "DONE INSTALLING M.L." 

RETURN 

REM %“#****@**@***@**m*m**** ***%*w*w*w*%**-* 


REM CALL INIT PAD 


IC=IC+1: IF IC=5 THEN 11110 
SYS 49152: ВЕМ 5С000 = INITPAD 
RETURN 

REM ========== 


REM INIT PAD HAS BEEN CALLED 5 TIMES 
PRINT "UNABLE TO TALK TO POWERPAD. DID" 
PRINT "YOU PLUG PAD INTO CONTROL PORT 1?" 
REM 
REM RE-ENABLE KEYBOARD 

PRINT "UNPLUG POWERPAD BEFORE TYPING." 

SYS 49161: REM $C009 = RESTORE 

END 

РЕМ žk kkk kkk kkk kk kkk kkk kkk kkk kk kk 

REM CALL GETSENSE 

SYS 49155: REM $C003 = GETSENSE 
SENSE=PEEK(49166): REM SC@@E = SNS 

IF SENSE<2 THEN 12100: REM SPACE NOT PRESSED 
PRINT "PROGRAM STOPPED.": GOTO 112190 

IF SENSE-1 THEN 12120: REM POINT NOT FOUND 


12110 
12120 
12130 
12140 
13000 
13010 
13020 
13030 
13040 
13050 
14000 
14010 
14020 
14030 
14040 
14050 
14060 
14070 
14080 
14090 
14100 
14110 
14120 
14130 
14140 
14150 
15000 
15010 
15020 
15100 
15110 
15120 
15130 
15200 
15210 
15220 
15230 
15240 
15250 
15300 
15310 
15320 
15330 
15340 
15350 
15400 
15410 
15420 
15430 
15440 
15500 
15510 
15520 


IC-0: RETURN: REM RESET INIT COUNTER 
GOSUB 110190: REM CALL INIT AGAIN 
GOTO.12010 | 


REM LXXEZEEEZEEEEEEZEEEEEREREEZEREEZ 


REM CALL GETXY 
SYS 49158: REM $C006 - GETXY 
X=PEEK (49165): REM $CØØD 
Y-PEEK(49164): REM 5С00С 

RETURN 

REM ХХХХХХХХХХХХХХХХХХХХХХХХХХХХҰЖ 
REM INSTALL MACH. LANG. SUBROUTINES 
FOR L249152 TO 49307: REM 5С000-С09В 
READ BYTES 

K=ASC (MIDS (BYTES,1,1))~48 

IF K>9 THEN К-К-7 

ВУТЕ=К*1 6 

K=ASC (MIDS (BYTES,2,1))~-48 

IF K»9 THEN K-K-7 

BYTE=BYTE+K 

POKE L,BYTE 

NEXT L 

RETURN 

REM READ HEXADECIMAL BYTE FROM DATA 
REM STATEMENTS; CONVERT BYTE TO 
REM DECIMAL; STORE VALUE IN MEMORY 
REM Kk k kk k Xk کا‎ kk kx xk xk اج < او باج جاو عاج ا باو کاو ا باو کاو کاو کاو کا‎ 
REM SUBROUTINE VECTORS & VARS 

БАТА 4С,й0Е,Сй0,4С,27,С0,4С,4Е 

DATA C0,4C,8E,C0,00,00,00 

REM INITPAD 

DATA A9,16,8D,03,DC,A9,00,8D 

DATA 02,DC,8D,01,DC,A9,02,8D 

DATA 01,DC,A9,00,8D,01,DC,60 

REM GETSENSE 

DATA A2,FF,A0,0F,AD,00,DC,29 

DATA 80,D0,06,A9,02,8D,0E,CO 

DATA 60,AD,01,DC,29,08,D0,04 

DATA 8D,0E,C0,60,CA,DO,E5,88 

DATA DO,E2,A9,01,8D,0E,C0,60 

REM GETXY 

DATA A9,04,8D,01,DC,A9,00,8D 

DATA 01,DC,20,71,C0,8D,0C,CO 

DATA 20,71,C0,8D,0D,C0,A9,02 

DATA 8D,01,DC,A9,00,8D,01,DC 

DATA 60 

REM GETBYTE 

DATA 00,A2,07,A9,04,8D,01,DC 

DATA A9,00,8D,01,DC,AD,01,DC 

DATA 4A,6E,70,COÓ,CA,DOÜ, EC, AD 

DATA 70,C0,49,FF,4A,60 

REM RESTORE 

DATA A9,FF,8D,02,DC,8D,00,DC 

DATA A9,00,8D,03,DC,60 
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Creating Your Own 
Command Buttons 


A command button is an area on the PowerPad 
surface which, when pushed, calls into action a 
subroutine within your program. You can 
design your own command buttons anywhere 
on the surface of PowerPad. Program 3 assists 
you by providing the range of values for X and 
Y corresponding to your command button. 

You can use the information Program 3 pro- 
vides to determine when your program will call 
its command button subroutines. 


Program 3: 
Command Button Mapper. You must also enter 


the 


machine language subroutines from Program 2 


(1іпеѕ 10000-15520) 


l REM **** COMMAND BUTTON MAPPER **** 


wood ль о м 


REM GIVES YOU THE RANGE OF X AND Y 
REM VALUES FOR YOUR COMMAND BUTTONS 
REM !REQUIRES THE MACHINE LANGUAGE 
REM SUBROUTINES (LINES 10000-15520) 
REM FROM PROGRAM 2! 

REM (YOU CAN LEAVE OUT ALL REMS) 
REM CHALK BOARD, INC. 1983 


10 REM* ******kokck ke sk x kx à à ke ke à à x kx à kx x kx kx x Ax xà x 


100 
110 
120 
130 
140 
150 
200 
210 
220 
230 
240 
1000 
1010 
1020 
1030 
1040 
1100 


PRINT CHR$(147): REM CLEAR SCREEN 
GOSUB 1010: REM INSTRUCTIONS & INIT VARS 
GOSUB 10010: REM SET UP M.L. 
GOSUB 11010: REM CALL INITPAD 
GOSUB 12010: REM CALL GETSENSE 
GOSUB 13010: REM CALL GETXY 
REM USE X AND Y 
IF X*Y-0 THEN 140 
GOSUB 2010: REM UPDATE RANGE 
GOTO 140 
REM ok ck eee ke ke he e kk ke e e ke ke e e ke ke ke ke e ke e k 
REM INSTRUCTIONS & INIT VARS 
XHI =0: REM LEFTMOST VALUE 
XLO=119: REM RIGHTMOST VALUE 
ҮНІ=0: REM BOTTOM VALUE 
YLO=119: REM TOP VALUE 
PRINT "COMMAND BUTTON MAPPER": PRINT 


1110 
1120 
1130 
1140 
1150 
1160 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
1260 
1270 
1280 
1290 
1300 
2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 


e Insert the grid overlay onto the surface of 
PowerPad. 

e Choose an area of PowerPads surface to 
represent your button. 

* Use your marking pen to draw a square to 
identify the location of your button. You 
can label or color your button any way 
you choose. 

* [f you need to change a buttons location, 
refer to Appendix A for instructions con- 
cerning erasing marks on your overlay. 


* Enter Program 3 into your computer. 
e RUN. 


PRINT "TO USE THIS PROGRAM:" 

PRINT "+ MOVE YOUR FINGER OVER THE" 
PRINT " ENTIRE AREA OF YOUR BUTTON" 
PRINT " STAYING *INSIDE* ITS OUTLINE" 


PRINT"- THE MAXIMUM AND MINUMUM X AND" 


PRINT " Y VALUES OF YOUR BUTTON" 
PRINT " WILL BE CONTINUOUSLY" 

PRINT " PRINTED." 

PRINT "—- CONTINUE TO PRESS THE BUTTON" 
PRINT " UNTIL THE X AND Y VALUES" 
PRINT " NO LONGER CHANGE." 

PRINT " (THESE ARE THE VALUES YOU" 
PRINT " SHOULD USE IN YOUR PROGRAM)" 
PRINT "= PRESS THE SPACE BAR TO STOP" 
PRINT " THIS PROGRAM." 

PRINT 

INPUT "PRESS RETURN WHEN READY";AS 
PRINT CHRS (147) 

RETURN 


REM k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 


REM UPDATE & PRINT RANGE OF X & Y 
IF X<XLO THEN XLO=X 

IF X>XHI THEN XHI=X 

IF Y<YLO THEN YLO=Y 

ТЕ Y>YHI THEN YHI=Y 

PRINT CHRS (147) 

PRINT "X»";XLO;"AND X«";XHI; 
PRINT "AND Y>"; YLO; "AND TCA THI 
PRINT: PRINT: PRINT 

RETURN 
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245 


ІЕ Х>20 


Once you have determined the range of values 
for X and Y (for example, X might range between 
20 and 30, and Y between 40 and 50), you can 
set up your program to know when you are 
pressing your command button. Assume that 
you want your command button to activate a 
routine which begins at line 3000 in your own 
program. To call the routine you must insert a 
line in your original PowerPad Test program to 
say the following: if I touch PowerPad at this 
spot, then go to line 3000 and do the routine 
there. This can be represented in BASIC in the 
following way: 


AND Х<30 АМО Ү>40 АМО Ү<50 ТНЕМ СОТО 3000 
In this example line 3000 is the beginning of the 


routine you want executed whenever your 
command button is pressed. 


When the program returns from the routine 
and reads the pad again, it might find that you 
are still pressing the command button. If the 
routine is called each time the pad reports a 
switch closure within your pushbutton area, 
then the routine is likely to be run several times 
for each push of the button. 

If you do not want the routine 
several times for each push of the button, there 
is an easy way to avoid re-running the routine. 
Use a variable to indicate whether or not the 
button has been pressed. When the pad reports 
a point within your button area, your program 
checks the variable to see if you have already 
pressed the button. If not, then it calls the 
routine to perform the function associated with 
that button and sets the variable to show that 
that function has been used. 

If the variable shows that you previously 
pressed the button, then the program ignores 
that button until you either lift your finger 
from the pad or touch another button. In both 
cases the program can then reset the variable so 
that the button will work the next time you 
press it. When your program reads the pad and 
finds two (X —0, Y —0) points in succession, it 
knows that nothing is touching the pad. 

Program 4, "Making Change; uses this 
method to insure that when you hold down a 
coin button, the value of that coin is added 
to your total only once. 
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Sample Programs 


Program 4 is an educational game in which 
you make change for random amounts of 
money (1-100 cents). Try changing some of the 
PRINT statements to have fun with the responses. 


Creating Your Overlay For “Making Change” 


e Fit the overlay on PowerPads surface. 

* Using a marking pen, divide the overlay 
into four equal vertical columns. See 
Figure 5. 

e° Mark each section with a drawing of its 
appropriate coin value. From left to right 
show: Quarter, Dime, Nickel, Penny. 
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"Making Change"' Program 


rig. 5, 
Overlay For 
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Program 4: 

Making Change. You must also enter the 
machine language subroutines from Program 2 
(11пе5 10000-15520) 


l REM ******** MAKING CHANGE ******** 

КЕМ АМ EDUCATIONAL GAME USING THE 

REM POWERPAD 

REM !REQUIRES THE MACHINE LANGUAGE 

REM SUBROUTINES (LINES 10000-15520) 

REM FROM PROGRAM 2! 

REM (YOU CAN LEAVE OUT ALL REMS) 

REM CHALK BOARD, INC. 1983 

10 REMX XK KK KOR OK OK OK OO OK OK k k k k k k k k k k k k k k k k k k 

100 PRINT CHR$(147): REM CLEAR SCREEN 

110 GOSUB 10010: REM SET UP M.L. 

120 GOSUB 1010: REM INIT VARS & PICK AMOUNT 
130 GOSUB 11010: REM CALL INITPAD 

140 GOSUB 12010: REM CALL GETSENSE 

150 GOSUB 13010: REM CALL СЕТХУ 

200 REM USE X AND Y 

210 GOSUB 2010 

220 GOTO 140 

230 REM ХХХХХХХХХХХХХХХХХХХХХХХХХХХХХХЖ 

1000 REM INIT VARIABLES 

1010 Р5=0: NS=@: DS=@: QS=@: REM # OF COINS 
1020 TTL=@: REM TOTOL VALUE OF COINS 

1930 AMT=INT(RND(@)*99)+1: REM # TO MATCH 
1040 PF=1: NF=1: DF-1: QF-1: REM "TOUCHED" FLAGS 
1050 PRINT 

1060 РВМТ "=======ЕЕЕЕ=Е ЕЕ => Р>ЕЕЕЕЕЕЕЕЕЕЕЕЕЕЕЙ 
1070 PRINT 

19080 PRINT "LET'S MAKE CHANGE FOR"; AMT; "CENTS" 
1090 PRINT 

1100 RETURN 

11189 REM kkkkkkkkkkkkkkkkkkkkkkkkkkkkkxk 

2000 REM CONVERT X & Y TO A COIN 

2010 IF X+Y=@ THEN 2100: REM NO POINT? 

2020 2Е=0: REM POINT WAS NOT (0,0) 

2030 IF Х>-й0 AND X<30 THEN 5010: REM PENNY 
2040 IF X»-30 AND X«60 THEN 6010: REM NICKEL 
2050 IF X>=6@ AND X«90 THEN 7010: REM DIME 
2060 ТЕ Х>=90 AND X«120 THEN 8010: REM QUARTER 
2100 ZF-ZF*1: REM COUNT CONSECUTIVE (0,9)'S 
2110 IF ZF<2 THEN RETURN: ONLY 1 SO FAR 

2120 GOSUB 3010: REM 2 SO CLEAR "TOUCHED" FLAGS 
2130 RETURN 

2140 РЕМ ХХХХХХХХХХХХХХХХХХХХХХХХХХХАХАҒК 

3000 REM CLEAR ALL "BUTTON TOUCHED" FLAGS 
3010 PF-0: NF-0: DF-0: QF-0 

3020 RETURN 

3030 REM ХХХХХХХХХХХХХХХХХХХХХХАХХХХХХЖХХ 


NO OO Ow Ui & W ƏN 


4000 
4010 
4020 
4030 
4040 
4050 
4060 
4070 
4080 
4090 
4100 
4110 
4120 
4130 
4140 
4150 
4160 
4170 
4180 
4190 
5000 
5010 
5020 
5030 
5040 
5050 
5060 
5070 
6000 
6010 
6020 
6030 
6040 
6050 
6060 
6070 
7000 
7010 
7020 
7030 
7040 
7050 
7060 
7070 
8000 
8010 
8020 
8030 
8040 
8050 
8060 
8070 


REM TOTAL UP COINS 

PRINT 

PRINT "MAKING CHANGE FOR"; AMT; "CENTS" 
PRINT 


IF PS»0 THEN PRINT " PENNIES:";PS 
ТЕ №5>0 THEN PRINT " NICKELS:";NS 
IF DS>@ THEN PRINT " DIMES:";DS 
IF QS»0 THEN PRINT " QUARTERS:";QS 
PRINT 


PRINT "YOUR TOTAL SO FAR IS";TTL;" CENTS" 
PRINT 

IF TTL>=AMT THEN 4130 

RETURN: REM NOT ENOUGH YET 

IF TTLOAMT THEN 4160 
PRINT"CONGRATULATIONS! YOU GOT IT! 

GOTO 4170 

PRINT "WHOOPS! THAT WAS TOO MUCH." 
СО5ОВ 1010: REM DO IT AGAIN 

RETURN 

REM XXX KOK KOK OK ORO oe oe coke ke ke ke ke e e he ek e e e e koe e ke 

REM PENNY WAS TOUCHED 

IF PF-1 THEN RETURN: REM WAS JUST TOUCHED 
GOSUB 3010: REM ALLOW ALL OTHER BUTTONS 
PF-1: REM SHOW THAT PENNY TOUCHED 
PS-PS*l: REM INCREMENT PENNY COUNTER 
TTL-TTL*1: REM UPDATE TOTAL 

GOTO 4010 ; 

REM %*“**#*<*<***********@********@*****m** 

REM NICKEL WAS TOUCHED 

IF NF=1 THEN RETURN: REM WAS JUST TOUCHED 
GOSUB 3010: REM ALLOW ALL OTHER BUTTONS 
NF=1: REM SHOW THAT NICKEL TOUCHED 
NS=NS+1: REM INCREMENT NICKEL COUNTER 
TTL=TTL+5: REM UPDATE TOTAL 

GOTO 4010 

REM KRKRKKKKKKKKKKKKKKKKKKKKKK KKK EK 

REM DIME WAS TOUCHED 

IF DF-1 THEN RETURN: REM WAS JUST TOUCHED 
GOSUB 3010: REM ALLOW ALL OTHER BUTTONS 
DF-1: REM SHOW THAT DIME TOUCHED 
DS-DS*1: REM INCREMENT DIME COUNTER 
TTL-TTL-*10: REM UPDATE TOTAL 

СОТО 4010 

REM **** koe ok ok oko e ke ke ke ke ke e e e e ee ke e e e kx x 

REM QUARTER WAS TOUCHED 

IF QF-1 THEN RETURN: REM WAS JUST TOUCHED 
GOSUB 3010: REM ALLOW ALL OTHER BUTTONS 
QF-1: REM SHOW THAT QUARTER TOUCHED 
05=05+1: REM INCREMENT QUARTER COUNTER 
TTL=TTL+25: REM UPDATE TOTAL 

GOTO 4010 


REM K¥ERRKRKKKKKKKKKKKKKKKKKKKKKKKKK 
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Program 5 is a small sample of the graphics 
capabilities of the Commodore 64 іп combina- 
tion with your PowerPad. The program draws a 
waving man on the screen when you touch the pad. 


—rar — 


Program 5: 


Waving Man. You must also enter the | 
machine language subroutines from Program 2 | 
(1іпеѕ 10000-15520) 


I REM k kk xxx xxx WAVING MAN * k *& k Ñx % x K Kx 
REM POWERPAD DEMONSTRATION PROGRAM 
REM !REQUIRES THE MACHINE LANGUAGE 
REM SUBROUTINES (LINES 10000-15529) 
REM FROM PROGRAM 2! 

REM (YOU CAN LEAVE OUT ALL REMS) 
REM CHALK BOARD, INC. 1983 

10 REM * * k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 
100 PRINT CHR$(147): REM CLEAR SCREEN 
110 GOSUB 1010 : REM SET UP GRAPHICS CHARS 
120 GOSUB 10010: REM SET ОР М.І. 

130 GOSUB 11010: REM CALL INITPAD 

140 GOSUB 12010: REM CALL GETSENSE 

150 GOSUB 13010: REM CALL GETXY 

200 REM USE X AND Y 

210 IF X*Y-0 THEN 140 

220 GOSUB 2010 Г 

230 СОТО 140 

240 REM & k k k k k k k k k k k k k kk k k k k k k k k k k k k k k k 
1000 REM INIT WAVING MAN 

1818 HDS=CHRS( 32)+CHRS(113)+CHRS( 32) 
1820 TPS=CHRS( 99)+CHRS (123)+CHRS( 99) 
1830 TRS=CHRS( 99)+CHRS (123)+CHRS (189) 
1848 TLS=CHRS (173)+CHRS (123) +CHRS( 99) 
19050 MDS-CHRS( 32)*CHRS$ (125) *CHRS$ ( 32) 
1868 LGS=CHRS(1190)+CHRS( 32)+CHRS (109) 
1078 PRINT "WAVING MAN" 


1080 RETURN 
1090 REM ****d d o oe ok ok ke ke kk ke k kk k k kk k 


хо со сул м 





2000 
2010 
2020 
2030 
2040 
2050 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2160 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
2260 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
2360 
2370 


REM DISPLAY WAVING МАМ 
ХР-((119-Х)%36)/119: REM COMPUTE LOCATION 
YP-(Y*21)/119: REM FROM X AND Y 
A=1024+(INT(YP)*40)+INT(XP) 
AH=INT(A/256): REM LOCATION FOR HEAD 
AL=A~ (AH*256) 

А=А+40 

ВН=ТМТ (А/256): REM LOCATION FOR ARMS 
BL-A- (BH*256) 

А=А+40 

СН-ІМТ(А/256): REM LOCATION FOR WAIST 
CL=A~ (CH*256) 

A=A+4@ 

DH=INT(A/256): REM LOCATION FOR LEGS 
DL=A~ (DH*256) | 

PRINT CHR$(147): REM CLEAR SCREEN 
FOR M-1 TO 2 

POKE 209,AL 

РОКЕ 210,АН 

PRINT HDS: REM DRAW HEAD 

РОКЕ 209, ВГ. 

РОКЕ 210,ВН 

PRINT TPS: REM DRAW STRAIGHT ARMS 
РОКЕ 209, СГ, 

POKE 210 ,СН 

PRINT MD$: REM DRAW WAIST 

РОКЕ 209,00. ` 

POKE 210,DH 

PRINT LG$: REM DRAW LEGS 

КОК М1=1 ТО 10: NEXT Ml: REM DELAY 
POKE 209,BL 

POKE 210,BH 

IF X>6@ THEN PRINT TLS: REM DRAW WAVING 


IF X<61 THEN PRINT TRS: REM ARMS 
FOR Ml-1 TO 10: NEXT Ml: REM DELAY 
NEXT M 
RETURN 


REM k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 
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Questions to Ponder 


A. How would you modify “Making Change” 
so that you must touch the pad only within the 
outline of each coin? 

B. How would you design a STOP com- 
mand button that, when pressed, would stop 
the program, replacing the function of the 
space bar? 

C. How could you change the PowerPad 
Test program to print out the value (1 or 0) 
for each data bit read in from the pad? How 
could you change the PowerPad Test program 
to print the state of the SENSE line (high or low)? 

D. On your PowerPad overlay draw a medium- 
sized rectangle with sides parallel to the sides of 
PowerPad. Then RUN the “Waving Man” pro- 
gram (Program 5). Next touch any three of the 
four corners of your rectangle simultaneously. 
Continue touching the three corners until the 
waving man has appeared at all positions several 
times. What do you notice about the route of 
the waving man? 


The waving man appears:at the fourth cor- 
ner of the rectangle—even though no pressure 
was applied to that point. This "false-image" is 
also known as “aliasing” What would explain 
this occurrence? How can you avoid this in 
your own programs? How can you take 
advantage of this in your own programs? 


Do you have any ideas that you would like 
to share with us about your experiences with 
the PowerPad Programming Kit? Do you want 
to know more about what other people are 
doing with PowerPad and Chalk Board prod- 
ucts? If so, please write to us at the address 
given at the front of this booklet. 

Your name will be placed on a list of users 
who receive our company newsletter. If you 
send us some of your ideas, you might also 
appear in our newsletter. 

Watch for coming issues of our newsletter, 
as well as upcoming additions to Leonardo's 
Library of quality software for your home 
computer. 
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Appendix A. Care of 
Overlays, Replacement Overlays 


The overlay is designed for use with col- 
ored marking pens of the sort included in the 
Programming Kit. Marks made by these pens 
should not smudge or smear significantly with 
normal use. The use of colored marking pens 
of another make is not recommended because 
they can smear or be more difficult to erase. 

To clean an overlay, use a damp cloth or 
paper towel. Always remove the overlay 
from PowerPad before cleaning since water 
may damage the surface of PowerPad. 

Additional overlays may be ordered from: 


Customer Support 
Chalk Board, Inc. 
Suite 140 

3772 Pleasantdale Rd. 
Atlanta, Georgia 30340 


The charge for each replacement overlay is 
$6.00, which includes $3.00 for the overlay 
itself and $3.00 for postage and handling. 
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PadMasters Guild 
Chalk Board, Inc. is making a special offer 


to you as an owner of a PowerPad and the 
PowerPad Programming Kit. You are invited to 
become a member of the PadMasters Guild. 
For a full year, your membership is free. After 
that, the annual membership and renewal fee is 
$9.95. Your membership includes: 


* Home delivery of quarterly publications 
containing new programs to run on your 
PowerPad. These publications serve as a 
clearing house for programs submitted by 
programmers like yourself. 

e Home delivery of issues of the Chalk 
Board newsletter. 

* Access to a special "Hot Line" telephone 
number which you can use for technical 
assistance. 

e Special issues and releases about new 
product data from Chalk Board, Inc. 


If you would like to become a member of the 
PadMasters Guild, complete this membership 
form and send it to: 


Chalk Board, Inc. 
3772 Pleasantdale Road 
Atlanta, Georgia 30340 


PadMasters Guild 


Membership Form 


Name 

Address 

а 
Ap A ауа. 

Type of Computer You Own/Use 
Type of Storage Device Used 
diskette cassette 
Purpose for which you use a Computer (check all that apply.) 
Games Business Education 

— Word Processing Homes Finances 


Zip 








none 
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